home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 23 / CU Amiga - Super CD-ROM 23 (June 1998).iso / CDSupport / UpDateCopy / Docs / UpDateCopy.doc < prev    next >
Encoding:
Text File  |  1998-03-18  |  7.9 KB  |  211 lines
  1.  
  2.                         Documentation to UpDateCopy
  3.  
  4.                           Version 1.5 - 17.03.1998
  5.                    $VER: UpDateCopy.doc 1.5 (17.03.1998)
  6.  
  7.  
  8.                          Written by Sven Steiniger
  9.                                -- Cardware --
  10.  
  11.  
  12. ------------------------------------------------------------------------------
  13.                                 Introduction
  14. ------------------------------------------------------------------------------
  15.  
  16.     UpDateCopy is an extension of the standard copy command. It does not
  17.     only copy files and create (if necessary) directories but also process
  18.     already existing files: older files are replaced automatical by newer
  19.     ones. UpDateCopy first try to find a version-string within the files
  20.     ($VER: Programname Version.Reversion) and copy only the one with the
  21.     higher version or simply compares the dates. If wanted it can also
  22.     check/update the 'archive' protection bit.
  23.     UpDateCopy features multiple sourcefiles, pattern matching and
  24.     recursively directory scanning.
  25.  
  26.  
  27. ------------------------------------------------------------------------------
  28.                             System requirements
  29. ------------------------------------------------------------------------------
  30.  
  31.     - an Amiga :-)
  32.     - at least KickStart 2.04
  33.     - asyncio.library v39
  34.  
  35.  
  36. ------------------------------------------------------------------------------
  37.                                 Installation
  38. ------------------------------------------------------------------------------
  39.  
  40.     Just copy 'UpDateCopy' to 'C:' and 'libs/asyncio.library' to 'LIBS:'
  41.     That's all!
  42.  
  43.  
  44. ------------------------------------------------------------------------------
  45.                                    Usage
  46. ------------------------------------------------------------------------------
  47.  
  48.  
  49.     Format:
  50.         UpDateCopy [FROM] {<sourcename|sourcepattern>} [TO] <destname>
  51.                    [QUIET] [ALL] [FORCE] [DEEP] [NODATECHECK]
  52.                    [TESTMODE] [CLONE] [PAPF] [SMARTINFO] [FAST]
  53.                    [NOASK] [CHECKARCBIT] [SETARCBIT] [PRECISEDS]
  54.  
  55.     Template:
  56.         UpDateCopy FROM/M,TO/A,QUIET/S,ALL/S,FORCE/S,DEEP/S,
  57.                    NDC=NODATECHECK/S,TESTMODE/S,CLONE/S,PAB=PAPF/S,
  58.                    SMARTINFO/S,FAST/S,NOASK/S,SAB=SETARCBIT/S,
  59.                            CAB=CHECKARCBIT/S,PRECISEDS/S
  60.  
  61.  
  62.  
  63.     Parameter:
  64.         sourcename, sourcepattern
  65.             The names of the files to be copied or directories
  66.             (also name patterns).
  67.         destname
  68.             Name of destination directory.
  69.         QUIET
  70.             Switch output off. Only error messages are displayed.
  71.         ALL
  72.             If specified than also subdirctories are scanned and
  73.             copied otherwise only files and directorynames of the
  74.             source directory.
  75.         FORCE
  76.             Normally delete-protected files could not be over-
  77.             written. If you specify this option UpDateCopy
  78.             ignores all Protectionbits.
  79.         DEEP
  80.             UpDateCopy only compares the dates of existing files.
  81.             With the DEEP-option UpDateCopy scans the files first
  82.             for version-strings ($VER:) and only if this fails
  83.             the dates are compared.
  84.             Note: Although this search is written in fast
  85.                   assembly language it slows things down.
  86.         NODATECHECK
  87.             UpDateCopy do not compare the datestamps.
  88.             Note: If you specify this option then DEEP-scanmode
  89.                   is turned on by default.
  90.         TESTMODE
  91.             Switchs the testmode on. UpDateCopy don't copy/replace
  92.             older files and directories are not created. But the
  93.             outputs are the same as without the testmode.
  94.             This option can be used for simply comparing the
  95.             contents of two directories.
  96.         CLONE
  97.             If you set this option, UpDateCopy copies the
  98.             datestamp from the source file.
  99.         PAB
  100.             Normally UpDateCopy clears the archive protection flag
  101.             of a copied file. If you set this option this flag is
  102.             not altered.
  103.             Note: UpDateCopy always copies
  104.                 - the protection flags (except archive)
  105.                 - and the file comment.
  106.         SMARTINFO
  107.             Now UpDateCopy don't displays skipped directories and
  108.             files.
  109.         FAST
  110.             Switches off linefeeds. This increases processing
  111.             speed if you copy many small files (scrolling the
  112.             display takes longer than scanning the file).
  113.         NOASK
  114.             I an error occurs UpDateCopy asks what to do now.
  115.             By setting this switch it simply aborts.
  116.         CHECKARCBIT
  117.             Only copy files/directories if their archive bit
  118.             is *not* set. Normally the archive bit is cleared
  119.             whenever an file is modified. In connection with
  120.             SETARCBIT you can easily copy changed files.
  121.             Note:    On files with cleared archive bit all
  122.                 compare modes (date check, DEEP) are
  123.                 performed.
  124.         SETARCBIT
  125.             Sets the archive bit on all copied files/directories.
  126.         PRECISEDS
  127.             Datestamps are now precisly compared.
  128.             Normally they are converted so that the seconds are
  129.             multiple of 2. This is what lha does and you won't
  130.             notice any difference except you try to replace an
  131.             file with datestamp eg. 14:03:44 by one with 14:03:45,
  132.             which will fail (but occur rather seldom).
  133.  
  134.     Examples:
  135.         UpDateCopy #? ram:T
  136.             Copies all files of the current directory to
  137.             "ram:T". Not existing files are copied. Not existing
  138.             directories are created. Existing files are only
  139.             overwritten if they have a older date.
  140.         UpDateCopy #? ram:T ALL
  141.             Same as previous but now also scans through sub-
  142.             directories.
  143.         UpDateCopy #? ram:T DEEP
  144.             Same as first example but do not only compares the
  145.             dates but first compare the version-strings (if
  146.             possible)
  147.         UpDateCopy #? ram:T DEEP NDC
  148.             Same as first example but do only compares the
  149.             version-strings. If no version-string is found nothing
  150.             is copied/replaced even if the datestamp is newer.
  151.             Also not existing directories are not created.
  152.         UpDateCopy #?.info #?.e TO=ram:T ALL DEEP esource:3D/Plotter3D
  153.             Copies all files of the of the current directory to
  154.             "ram:T" which ends with ".info" or ".e". Also sub-
  155.             directories are scanned and the file
  156.             "esource:3D/Plotter3D" is copied.
  157.         UpdateCopy sys: TO backup: ALL CAB SAB SMARTINFO
  158.             This is my normal backup routine. It copies only
  159.             changed files (archive bit), sets the archive bit on
  160.             the copied files and shows a list of all copied files.
  161.  
  162. ------------------------------------------------------------------------------
  163.                                    Author
  164. ------------------------------------------------------------------------------
  165.  
  166.     Send Bugreports, Ideas or anything else to:
  167.  
  168.                                Sven Steiniger
  169.  
  170.                               Rathener Str. 29
  171.                                01259 Dresden
  172.                                 Deutschland
  173.  
  174.                        Email: ss37@inf.tu-dresden.de
  175.  
  176. ------------------------------------------------------------------------------
  177.                                 Legal Stuff
  178. ------------------------------------------------------------------------------
  179.  
  180. UpDateCopy is CARDWARE, means that you should send me an email if you use it.
  181. Also small presents are very welcome.
  182.  
  183.  Copyright
  184. -----------
  185. UpDateCopy is written by Sven Steiniger. You may use the source freely in your
  186. programs or you may extend it to your own UpDateCopy. But please do not spread
  187. a modified version under this name (UpDateCopy). If the source was useful to
  188. you it would be a good idea to send me your program.
  189.  
  190.  Distribution
  191. --------------
  192. This program can be freely distributed as long as the archiv-contents is
  193. not changed and no profits are made.
  194. Archiv contents:
  195.     UpDateCopy/UpDateCopy        - the executable
  196.     UpDateCopy/Source/UpDateCopy.e    - the source file (E language)
  197.     UpDateCopy/Docs/UpDateCopy.doc    - english documentation
  198.     UpDateCopy/Docs/UpDateCopy.dok  - german documentation
  199.     UpDateCopy/Scripts/BackUpUp     - Backup-script by Attilio Scifoni
  200.     UpDateCopy/Scripts/BackUpUp2    - modified BackUpUp-script
  201.     UpDateCopy/Scripts/BackUpUp_GUI - BackUpUp2 with requesters
  202.     UpDateCopy/Scripts/BackUpUp.doc - english description of these scripts
  203.     UpDateCopy/readme        - short information english
  204.     UpDateCopy/liesmich        - short information german
  205.  
  206.  
  207.  Disclaimer
  208. ------------
  209. I am (The author) are in no way liable for damages or loss of data directly or
  210. indirectly caused by this program.
  211.